home *** CD-ROM | disk | FTP | other *** search
/ Halting the Hacker - A P…uide to Computer Security / Halting the Hacker - A Practical Guide to Computer Security.iso / rfc / rfc1284.txt < prev    next >
Text File  |  1997-04-01  |  43KB  |  1,179 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                    J. Cook, Editor
  8. Request for Comments: 1284                           Chipcom Corporation
  9.                                                            December 1991
  10.  
  11.  
  12.                      Definitions of Managed Objects
  13.                  for the Ethernet-like Interface Types
  14.  
  15. Status of this Memo
  16.  
  17.    This memo is an extension to the SNMP MIB.  This RFC specifies an IAB
  18.    standards track protocol for the Internet community, and requests
  19.    discussion and suggestions for improvements.  Please refer to the
  20.    current edition of the "IAB Official Protocol Standards" for the
  21.    standardization state and status of this protocol.  Distribution of
  22.    this memo is unlimited.
  23.  
  24. Table of Contents
  25.  
  26.    1. Abstract...............................................    1
  27.    2. The Network Management Framework.......................    1
  28.    3. Objects ...............................................    2
  29.    3.1 Format of Definitions ................................    2
  30.    4. Overview ..............................................    3
  31.    5. Definitions ...........................................    4
  32.    5.1 The Generic Ethernet-like Group ......................    4
  33.    5.2 The Ethernet-Like Statistics Group ...................    9
  34.    5.3 The Ethernet-like Collision Statistics Group .........   16
  35.    5.4 802.3 Tests ..........................................   17
  36.    5.5 802.3 Hardware Chipsets ..............................   18
  37.    6. Acknowledgements ......................................   19
  38.    7. References ............................................   19
  39.    Security Considerations...................................   21
  40.    Author's Address..........................................   21
  41.  
  42. 1.  Abstract
  43.  
  44.    This memo defines a portion of the Management Information Base (MIB)
  45.    for use with network management protocols in TCP/IP-based internets.
  46.    In particular, it defines objects for managing ethernet-like objects.
  47.  
  48. 2.  The Network Management Framework
  49.  
  50.    The Internet-standard Network Management Framework consists of three
  51.    components.  They are:
  52.  
  53.       RFC 1155 which defines the SMI, the mechanisms used for describing
  54.       and naming objects for the purpose of management.  RFC 1212
  55.  
  56.  
  57.  
  58. Transmission MIB Working Group                                  [Page 1]
  59.  
  60. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  61.  
  62.  
  63.       defines a more concise description mechanism, which is wholly
  64.       consistent with the SMI.
  65.  
  66.       RFC 1156 which defines MIB-I, the core set of managed objects for
  67.       the Internet suite of protocols.  RFC 1213, defines MIB-II, an
  68.       evolution of MIB-I based on implementation experience and new
  69.       operational requirements.
  70.  
  71.       RFC 1157 which defines the SNMP, the protocol used for network
  72.       access to managed objects.
  73.  
  74.    The Framework permits new objects to be defined for the purpose of
  75.    experimentation and evaluation.
  76.  
  77. 3.  Objects
  78.  
  79.    Managed objects are accessed via a virtual information store, termed
  80.    the Management Information Base or MIB.  Objects in the MIB are
  81.    defined using the subset of Abstract Syntax Notation One (ASN.1) [7]
  82.    defined in the SMI.  In particular, each object has a name, a syntax,
  83.    and an encoding.  The name is an object identifier, an
  84.    administratively assigned name, which specifies an object type.  The
  85.    object type together with an object instance serves to uniquely
  86.    identify a specific instantiation of the object.  For human
  87.    convenience, we often use a textual string, termed the OBJECT
  88.    DESCRIPTOR, to also refer to the object type.
  89.  
  90.    The syntax of an object type defines the abstract data structure
  91.    corresponding to that object type.  The ASN.1 language is used for
  92.    this purpose.  However, the SMI [3] purposely restricts the ASN.1
  93.    constructs which may be used.  These restrictions are explicitly made
  94.    for simplicity.
  95.  
  96.    The encoding of an object type is simply how that object type is
  97.    represented using the object type's syntax.  Implicitly tied to the
  98.    notion of an object type's syntax and encoding is how the object type
  99.    is represented when being transmitted on the network.
  100.  
  101.    The SMI specifies the use of the basic encoding rules of ASN.1 [8],
  102.    subject to the additional requirements imposed by the SNMP.
  103.  
  104. 3.1.  Format of Definitions
  105.  
  106.    Section 5 contains contains the specification of all object types
  107.    contained in this MIB module.  The object types are defined using the
  108.    conventions defined in the SMI, as amended by the extensions
  109.    specified in [13].
  110.  
  111.  
  112.  
  113.  
  114. Transmission MIB Working Group                                  [Page 2]
  115.  
  116. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  117.  
  118.  
  119. 4.  Overview
  120.  
  121.    Instances of these object types represent attributes of an interface
  122.    to an ethernet-like communications medium.  At present, ethernet-like
  123.    media are identified by three values of the ifType object in the
  124.    Internet-standard MIB:
  125.  
  126.                ethernet-csmacd(6)
  127.                iso88023-csmacd(7)
  128.                starLan(11)
  129.  
  130.    For these interfaces, the value of the ifSpecific variable in the
  131.    MIB-II [6] has the OBJECT IDENTIFIER value:
  132.  
  133.                dot3    OBJECT IDENTIFER ::= { transmission 7 }
  134.  
  135.    The definitions presented here are based on the IEEE 802.3 Layer
  136.    Management Specification [9], as originally interpreted by Frank
  137.    Kastenholz of Interlan in [10].  Implementors of these MIB objects
  138.    should note that the IEEE document explicitly describes (in the form
  139.    of Pascal pseudocode) when, where, and how various MAC attributes are
  140.    measured.  The IEEE document also describes the effects of MAC
  141.    actions that may be invoked by manipulating instances of the MIB
  142.    objects defined here.
  143.  
  144.    To the extent that some of the attributes defined in [9] are
  145.    represented by previously defined objects in the Internet-standard
  146.    MIB or in the generic interface extensions MIB [11], such attributes
  147.    are not redundantly represented by objects defined in this memo.
  148.    Among the attributes represented by objects defined in other memos
  149.    are the number of octets transmitted or received on a particular
  150.    interface, the number of frames transmitted or received on a
  151.    particular interface, the promiscuous status of an interface, the MAC
  152.    address of an interface, and multicast information associated with an
  153.    interface.
  154.  
  155.    The relationship between an ethernet-like interface and an interface
  156.    in the context of the Internet-standard MIB is one-to-one.  As such,
  157.    the value of an ifIndex object instance can be directly used to
  158.    identify corresponding instances of the objects defined herein.
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170. Transmission MIB Working Group                                  [Page 3]
  171.  
  172. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  173.  
  174.  
  175. 5.  Definitions
  176.  
  177.  
  178.     RFC1284-MIB DEFINITIONS ::= BEGIN
  179.  
  180.     IMPORTS
  181.             Counter, Gauge
  182.                     FROM RFC1155-SMI
  183.             transmission
  184.                     FROM RFC1213-MIB
  185.             OBJECT-TYPE
  186.                     FROM RFC-1212;
  187.  
  188.     --  This MIB module uses the extended OBJECT-TYPE macro as
  189.     --  defined in [13]
  190.  
  191.  
  192.     --  this is the MIB module for ethernet-like objects
  193.  
  194.     dot3    OBJECT IDENTIFIER ::= { transmission 7 }
  195.  
  196.  
  197.     -- the Generic Ethernet-like group
  198.  
  199.     -- Implementation of this group is mandatory for all systems
  200.     -- that attach to an ethernet-like medium.
  201.  
  202.     dot3Table OBJECT-TYPE
  203.         SYNTAX  SEQUENCE OF Dot3Entry
  204.         ACCESS  not-accessible
  205.         STATUS  mandatory
  206.         DESCRIPTION
  207.                 "Status information and control variables for a
  208.                 collection of ethernet-like interfaces attached to
  209.                 a particular system."
  210.         ::= { dot3 1 }
  211.  
  212.     dot3Entry OBJECT-TYPE
  213.         SYNTAX  Dot3Entry
  214.         ACCESS  not-accessible
  215.         STATUS  mandatory
  216.         DESCRIPTION
  217.                 "Status information and control variables for a
  218.                 particular interface to an ethernet-like medium."
  219.         INDEX   { dot3Index }
  220.         ::= { dot3Table 1 }
  221.  
  222.  
  223.  
  224.  
  225.  
  226. Transmission MIB Working Group                                  [Page 4]
  227.  
  228. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  229.  
  230.  
  231.     Dot3Entry ::=
  232.         SEQUENCE {
  233.             dot3Index
  234.                 INTEGER,
  235.             dot3InitializeMac
  236.                 INTEGER,
  237.             dot3MacSubLayerStatus
  238.                 INTEGER,
  239.             dot3MulticastReceiveStatus
  240.                 INTEGER,
  241.             dot3TxEnabled
  242.                 INTEGER,
  243.             dot3TestTdrValue
  244.                 Gauge
  245.        }
  246.  
  247.     dot3Index OBJECT-TYPE
  248.         SYNTAX  INTEGER
  249.         ACCESS  read-only
  250.         STATUS  mandatory
  251.         DESCRIPTION
  252.                 "An index value that uniquely identifies an
  253.                 interface to an ethernet-like medium.  The
  254.                 interface identified by a particular value of this
  255.                 index is the same interface as identified by the
  256.                 same value of ifIndex."
  257.         ::= { dot3Entry 1 }
  258.  
  259.     dot3InitializeMac OBJECT-TYPE
  260.         SYNTAX  INTEGER { initialized(1), uninitialized(2) }
  261.         ACCESS  read-write
  262.         STATUS  mandatory
  263.         DESCRIPTION
  264.                 "The initialization status of the MAC and PLS
  265.                 (Physical Layer Signalling) subsystems for a
  266.                 particular interface. The value initialized(1)
  267.                 signifies that the subsystems for a particular
  268.                 interface have been previously initialized; the
  269.                 value uninitialized(2) signifies that they have
  270.                 not been previously initialized.
  271.  
  272.                 Each alteration of an instance of this object to
  273.                 either of the values initialized(1) or
  274.                 uninitialized(2) is analogous to an invocation of
  275.                 the initializeMAC action defined in [9] and has
  276.                 the effect of (re-)initializing the MAC and PLS
  277.                 subsystems for the associated interface. In
  278.                 particular,
  279.  
  280.  
  281.  
  282. Transmission MIB Working Group                                  [Page 5]
  283.  
  284. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  285.  
  286.  
  287.                      all management counters pertaining to the MAC
  288.                      and PLS subsystems for said interface are
  289.                      reset to zero;
  290.  
  291.                      the receive and transmit layer management
  292.                      state variables (receiveEnabled and
  293.                      transmitEnabled in [9]) are set to enable
  294.                      reception and transmission of frames;
  295.  
  296.                      the promiscuous receive function is disabled;
  297.                      and
  298.  
  299.                      multicast reception is disabled."
  300.         ::= { dot3Entry 2 }
  301.  
  302.     dot3MacSubLayerStatus OBJECT-TYPE
  303.         SYNTAX  INTEGER { enabled(1), disabled(2) }
  304.         ACCESS  read-write
  305.         STATUS  mandatory
  306.         DESCRIPTION
  307.                 "The operational status of the MAC sublayer for a
  308.                 particular interface.  The value enabled(1)
  309.                 signifies that the MAC sublayer for said interface
  310.                 is operational for both transmitting and receiving
  311.                 frames -- that is, that the value of both the
  312.                 receive and transmit layer management state
  313.                 variables (receiveEnabled and transmitEnabled in
  314.                 [9]) for said interface are true.  The value
  315.                 disabled(2) signifies that the MAC sublayer for
  316.                 said interface is not operational for either
  317.                 transmitting or receiving frames. In particular,
  318.                 the value of an instance of this object is
  319.                 disabled(2) whenever the value of the
  320.                 corresponding instance of the dot3Enabled object
  321.                 is false(2).
  322.  
  323.                 Each alteration of an instance of this object to
  324.                 the value enabled(1) is analogous to an invocation
  325.                 of the enableMACSublayer action defined in [9] and
  326.                 has the effect of starting normal transmit and
  327.                 receive operations (from the ``idle'' state) on
  328.                 the associated interface. In particular, such an
  329.                 alteration has the effect of resetting the PLS for
  330.                 said interface and of setting the receive and
  331.                 transmit layer management state variables
  332.                 (receiveEnabled and transmitEnabled in [9]) to be
  333.                 true.
  334.  
  335.  
  336.  
  337.  
  338. Transmission MIB Working Group                                  [Page 6]
  339.  
  340. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  341.  
  342.  
  343.                 Each alteration of an instance of this object to
  344.                 the value disabled(2) is analogous to an
  345.                 invocation of the disableMACSublayer action
  346.                 defined in [9] and has the effect of terminating
  347.                 transmit and receive operations on the associated
  348.                 interface. In particular, such an alteration has
  349.                 the effect of setting the receive and transmit
  350.                 layer management state variables (receiveEnabled
  351.                 and transmitEnabled in [9]) to be false. Any
  352.                 transmissions/receptions in progress are completed
  353.                 before operation is terminated."
  354.         ::= { dot3Entry 3 }
  355.  
  356.     dot3MulticastReceiveStatus OBJECT-TYPE
  357.         SYNTAX  INTEGER { enabled(1), disabled(2) }
  358.         ACCESS  read-write
  359.         STATUS  mandatory
  360.         DESCRIPTION
  361.                 "The multicast receive status for a particular
  362.                 interface.  The value enabled(1) signifies that
  363.                 reception of multicast frames by the MAC sublayer
  364.                 is enabled on said interface. The value
  365.                 disabled(2) signifies that reception of multicast
  366.                 frames by the MAC sublayer is not enabled on said
  367.                 interface.
  368.  
  369.                 Each alteration of an instance of this object to
  370.                 the value enabled(1) is analogous to an invocation
  371.                 of the enableMulticastReceive action defined in
  372.                 [9] and has the effect of enabling multicast frame
  373.                 reception on the associated interface. Actual
  374.                 reception of multicast frames is only possible on
  375.                 an interface when the values for the associated
  376.                 instances of the dot3MulticastReceiveStatus and
  377.                 dot3MacSubLayerStatus objects are enabled(1) and
  378.                 enabled(1), respectively.
  379.  
  380.                 Each alteration of an instance of this object to
  381.                 the value disabled(2) is analogous to an
  382.                 invocation of the disableMulticastReceive action
  383.                 defined in [9] and has the effect of inhibiting
  384.                 multicast frame reception on the associated
  385.                 interface."
  386.         ::= { dot3Entry 4 }
  387.  
  388.     dot3TxEnabled OBJECT-TYPE
  389.         SYNTAX  INTEGER { true(1), false(2)  }
  390.         ACCESS  read-write
  391.  
  392.  
  393.  
  394. Transmission MIB Working Group                                  [Page 7]
  395.  
  396. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  397.  
  398.  
  399.         STATUS  mandatory
  400.         DESCRIPTION
  401.                 "The transmit layer management state variable
  402.                 (transmitEnabled as defined in [9]) for a
  403.                 particular interface.  The value true(1) signifies
  404.                 that the MAC frame transmission is enabled on said
  405.                 interface. The value false(2) signifies that the
  406.                 MAC frame transmission is inhibited on said
  407.                 interface. In particular, the value of an instance
  408.                 of this object is false(2) whenever the value of
  409.                 the corresponding instance of the
  410.                 dot3MacSubLayerStatus object is disabled(2).
  411.  
  412.                 Each alteration of an instance of this object to
  413.                 the value true(1) is analogous to an invocation of
  414.                 the enableTransmit action defined in [9] and has
  415.                 the effect of enabling MAC sublayer frame
  416.                 transmission on the associated interface. In
  417.                 particular, such an alteration has the effect of
  418.                 setting the transmit layer management state
  419.                 variable (transmitEnabled in [9]) for said
  420.                 interface to be true.
  421.  
  422.                 Each alteration of an instance of this object to
  423.                 the value false(2) is analogous to an invocation
  424.                 of the disableTransmit action defined in [9] and
  425.                 has the effect of inhibiting MAC sublayer frame
  426.                 transmission on the associated interface. In
  427.                 particular, such an alteration has the effect of
  428.                 setting the transmit layer management state
  429.                 variable (transmitEnabled in [9]) for said
  430.                 interface to be false. Any transmissions in
  431.                 progress are completed before transmission is
  432.                 inhibited."
  433.         ::= { dot3Entry 5 }
  434.  
  435.     dot3TestTdrValue OBJECT-TYPE
  436.         SYNTAX  Gauge
  437.         ACCESS  read-only
  438.         STATUS  mandatory
  439.         DESCRIPTION
  440.                "The number of 10 MHz ticks which elapsed between
  441.                the beginning of a TDR measurement and the
  442.                collision which ended it, for the most recently
  443.                executed TDR test.  If no TDR test has been
  444.                executed, or the last TDR value is not available,
  445.               this object has the value 0."
  446.         ::= { dot3Entry 6 }
  447.  
  448.  
  449.  
  450. Transmission MIB Working Group                                  [Page 8]
  451.  
  452. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  453.  
  454.  
  455.     -- the Ethernet-like Statistics group
  456.  
  457.     -- Implementation of this group is mandatory
  458.  
  459.     -- Due to implementation restrictions (e.g. in the
  460.     -- instrumentation provided by a chipset, or a device
  461.     -- driver), some of the counters in this group may be
  462.     -- difficult or impossible to implement.
  463.     -- In such cases, an implementator should apply reasonable
  464.     -- best effort to detect as many occurrences as possible.
  465.     -- In any case, the value of a counter will be the number
  466.     -- actually detected, which will always be less or equal
  467.     -- to the number of actual occurrences.  In the extreme
  468.     -- case of a total inability to detect occurrences, the
  469.     -- counter will always be zero.
  470.  
  471.     -- Vendors are strongly encouraged to document in user guides and
  472.     -- other appropriate documentation the conditions under which the
  473.     -- values of the counters in this group may represent an
  474.     -- underestimate of the true count.
  475.  
  476.     dot3StatsTable OBJECT-TYPE
  477.         SYNTAX  SEQUENCE OF Dot3StatsEntry
  478.         ACCESS  not-accessible
  479.         STATUS  mandatory
  480.         DESCRIPTION
  481.                 "Statistics for a collection of ethernet-like
  482.                 interfaces attached to a particular system."
  483.         ::= { dot3 2 }
  484.  
  485.     dot3StatsEntry OBJECT-TYPE
  486.         SYNTAX  Dot3StatsEntry
  487.         ACCESS  not-accessible
  488.         STATUS  mandatory
  489.         DESCRIPTION
  490.                 "Statistics for a particular interface to an
  491.                 ethernet-like medium."
  492.         INDEX   { dot3StatsIndex }
  493.         ::= { dot3StatsTable 1 }
  494.  
  495.     Dot3StatsEntry ::=
  496.         SEQUENCE {
  497.             dot3StatsIndex
  498.                 INTEGER,
  499.             dot3StatsAlignmentErrors
  500.                 Counter,
  501.             dot3StatsFCSErrors
  502.                 Counter,
  503.  
  504.  
  505.  
  506. Transmission MIB Working Group                                  [Page 9]
  507.  
  508. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  509.  
  510.  
  511.             dot3StatsSingleCollisionFrames
  512.                 Counter,
  513.             dot3StatsMultipleCollisionFrames
  514.                 Counter,
  515.             dot3StatsSQETestErrors
  516.                 Counter,
  517.             dot3StatsDeferredTransmissions
  518.                 Counter,
  519.             dot3StatsLateCollisions
  520.                 Counter,
  521.             dot3StatsExcessiveCollisions
  522.                 Counter,
  523.             dot3StatsInternalMacTransmitErrors
  524.                 Counter,
  525.             dot3StatsCarrierSenseErrors
  526.                 Counter,
  527.             dot3StatsExcessiveDeferrals
  528.                 Counter,
  529.             dot3StatsFrameTooLongs
  530.                 Counter,
  531.             dot3StatsInRangeLengthErrors
  532.                 Counter,
  533.             dot3StatsOutOfRangeLengthFields
  534.                 Counter,
  535.             dot3StatsInternalMacReceiveErrors
  536.                 Counter
  537.         }
  538.  
  539.     dot3StatsIndex OBJECT-TYPE
  540.         SYNTAX  INTEGER
  541.         ACCESS  read-only
  542.         STATUS  mandatory
  543.         DESCRIPTION
  544.                 "An index value that uniquely identifies an
  545.                 interface to an ethernet-like medium.  The
  546.                 interface identified by a particular value of this
  547.                 index is the same interface as identified by the
  548.                 same value of ifIndex."
  549.         ::= { dot3StatsEntry 1 }
  550.  
  551.     dot3StatsAlignmentErrors OBJECT-TYPE
  552.         SYNTAX  Counter
  553.         ACCESS  read-only
  554.         STATUS  mandatory
  555.         DESCRIPTION
  556.                 "A count of frames received on a particular
  557.                 interface that are not an integral number of
  558.                 octets in length and do not pass the FCS check.
  559.  
  560.  
  561.  
  562. Transmission MIB Working Group                                 [Page 10]
  563.  
  564. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  565.  
  566.  
  567.                 The count represented by an instance of this
  568.                 object is incremented when the alignmentError
  569.                 status is returned by the MAC service to the LLC
  570.                 (or other MAC user). Received frames for which
  571.                 multiple error conditions obtain are, according to
  572.                 the conventions of [9], counted exclusively
  573.                 according to the error status presented to the
  574.                 LLC."
  575.         ::= { dot3StatsEntry 2 }
  576.  
  577.     dot3StatsFCSErrors OBJECT-TYPE
  578.         SYNTAX  Counter
  579.         ACCESS  read-only
  580.         STATUS  mandatory
  581.         DESCRIPTION
  582.                 "A count of frames received on a particular
  583.                 interface that are an integral number of octets in
  584.                 length but do not pass the FCS check.
  585.  
  586.                 The count represented by an instance of this
  587.                 object is incremented when the frameCheckError
  588.                 status is returned by the MAC service to the LLC
  589.                 (or other MAC user). Received frames for which
  590.                 multiple error conditions obtain are, according to
  591.                 the conventions of [9], counted exclusively
  592.                 according to the error status presented to the
  593.                 LLC."
  594.         ::= { dot3StatsEntry 3 }
  595.  
  596.     dot3StatsSingleCollisionFrames OBJECT-TYPE
  597.         SYNTAX  Counter
  598.         ACCESS  read-only
  599.         STATUS  mandatory
  600.         DESCRIPTION
  601.                 "A count of successfully transmitted frames on a
  602.                 particular interface for which transmission is
  603.                 inhibited by exactly one collision.
  604.  
  605.                 A frame that is counted by an instance of this
  606.                 object is also counted by the corresponding
  607.                 instance of either the ifOutUcastPkts or
  608.                 ifOutNUcastPkts object and is not counted by the
  609.                 corresponding instance of the
  610.                 dot3StatsMultipleCollisionFrames object."
  611.        ::= { dot3StatsEntry 4 }
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618. Transmission MIB Working Group                                 [Page 11]
  619.  
  620. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  621.  
  622.  
  623.     dot3StatsMultipleCollisionFrames OBJECT-TYPE
  624.         SYNTAX  Counter
  625.         ACCESS  read-only
  626.         STATUS  mandatory
  627.         DESCRIPTION
  628.                 "A count of successfully transmitted frames on a
  629.                 particular interface for which transmission is
  630.                 inhibited by more than one collision.
  631.  
  632.                 A frame that is counted by an instance of this
  633.                 object is also counted by the corresponding
  634.                 instance of either the ifOutUcastPkts or
  635.                 ifOutNUcastPkts object and is not counted by the
  636.                 corresponding instance of the
  637.                 dot3StatsSingleCollisionFrames object."
  638.         ::= { dot3StatsEntry 5 }
  639.  
  640.     dot3StatsSQETestErrors OBJECT-TYPE
  641.         SYNTAX  Counter
  642.         ACCESS  read-only
  643.         STATUS  mandatory
  644.         DESCRIPTION
  645.                 "A count of times that the SQE TEST ERROR message
  646.                 is generated by the PLS sublayer for a particular
  647.                 interface. The SQE TEST ERROR message is defined
  648.                 in section 7.2.2.2.4 of [12] and its generation is
  649.                 described in section 7.2.4.6 of the same
  650.                 document."
  651.         ::= { dot3StatsEntry 6 }
  652.  
  653.     dot3StatsDeferredTransmissions OBJECT-TYPE
  654.         SYNTAX  Counter
  655.         ACCESS  read-only
  656.         STATUS  mandatory
  657.         DESCRIPTION
  658.                 "A count of frames for which the first
  659.                 transmission attempt on a particular interface is
  660.                 delayed because the medium is busy.
  661.  
  662.                 The count represented by an instance of this
  663.                 object does not include frames involved in
  664.                 collisions."
  665.         ::= { dot3StatsEntry 7 }
  666.  
  667.     dot3StatsLateCollisions OBJECT-TYPE
  668.         SYNTAX  Counter
  669.         ACCESS  read-only
  670.         STATUS  mandatory
  671.  
  672.  
  673.  
  674. Transmission MIB Working Group                                 [Page 12]
  675.  
  676. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  677.  
  678.  
  679.         DESCRIPTION
  680.                 "The number of times that a collision is detected
  681.                 on a particular interface later than 512 bit-times
  682.                 into the transmission of a packet.
  683.  
  684.                 Five hundred and twelve bit-times corresponds to
  685.                 51.2 microseconds on a 10 Mbit/s system. A (late)
  686.                 collision included in a count represented by an
  687.                 instance of this object is also considered as a
  688.                 (generic) collision for purposes of other
  689.                 collision-related statistics."
  690.         ::= { dot3StatsEntry 8 }
  691.  
  692.     dot3StatsExcessiveCollisions OBJECT-TYPE
  693.         SYNTAX  Counter
  694.         ACCESS  read-only
  695.         STATUS  mandatory
  696.         DESCRIPTION
  697.                 "A count of frames for which transmission on a
  698.                 particular interface fails due to excessive
  699.                 collisions."
  700.         ::= { dot3StatsEntry 9 }
  701.  
  702.     dot3StatsInternalMacTransmitErrors OBJECT-TYPE
  703.         SYNTAX  Counter
  704.         ACCESS  read-only
  705.         STATUS  mandatory
  706.         DESCRIPTION
  707.                 "A count of frames for which transmission on a
  708.                 particular interface fails due to an internal MAC
  709.                 sublayer transmit error. A frame is only counted
  710.                 by an instance of this object if it is not counted
  711.                 by the corresponding instance of either the
  712.                 dot3StatsLateCollisions object, the
  713.                 dot3StatsExcessiveCollisions object, the
  714.                 dot3StatsCarrierSenseErrors object, or the
  715.                 dot3StatsExcessiveDeferrals object.
  716.  
  717.                 The precise meaning of the count represented by an
  718.                 instance of this object is implementation-
  719.                 specific.  In particular, an instance of this
  720.                 object may represent a count of transmission
  721.                 errors on a particular interface that are not
  722.                 otherwise counted."
  723.         ::= { dot3StatsEntry 10 }
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. Transmission MIB Working Group                                 [Page 13]
  731.  
  732. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  733.  
  734.  
  735.     dot3StatsCarrierSenseErrors OBJECT-TYPE
  736.         SYNTAX  Counter
  737.         ACCESS  read-only
  738.         STATUS  mandatory
  739.         DESCRIPTION
  740.                 "The number of times that the carrier sense
  741.                 condition was lost or never asserted when
  742.                 attempting to transmit a frame on a particular
  743.                 interface.
  744.  
  745.                 The count represented by an instance of this
  746.                 object is incremented at most once per
  747.                 transmission attempt, even if the carrier sense
  748.                 condition fluctuates during a transmission
  749.                 attempt."
  750.         ::= { dot3StatsEntry 11 }
  751.  
  752.     dot3StatsExcessiveDeferrals OBJECT-TYPE
  753.         SYNTAX  Counter
  754.         ACCESS  read-only
  755.         STATUS  mandatory
  756.         DESCRIPTION
  757.                 "A count of frames for which transmission on a
  758.                 particular interface is deferred for an excessive
  759.                 period of time."
  760.         ::= { dot3StatsEntry 12 }
  761.  
  762.     dot3StatsFrameTooLongs OBJECT-TYPE
  763.         SYNTAX  Counter
  764.         ACCESS  read-only
  765.         STATUS  mandatory
  766.         DESCRIPTION
  767.                 "A count of frames received on a particular
  768.                 interface that exceed the maximum permitted frame
  769.                 size.
  770.  
  771.                 The count represented by an instance of this
  772.                 object is incremented when the frameTooLong status
  773.                 is returned by the MAC service to the LLC (or
  774.                 other MAC user). Received frames for which
  775.                 multiple error conditions obtain are, according to
  776.                 the conventions of [9], counted exclusively
  777.                 according to the error status presented to the
  778.                 LLC."
  779.         ::= { dot3StatsEntry 13 }
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786. Transmission MIB Working Group                                 [Page 14]
  787.  
  788. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  789.  
  790.  
  791.     dot3StatsInRangeLengthErrors OBJECT-TYPE
  792.         SYNTAX  Counter
  793.         ACCESS  read-only
  794.         STATUS  mandatory
  795.         DESCRIPTION
  796.                 "A count of frames received on a particular
  797.                 interface with a length field value that falls
  798.                 between the minimum unpadded LLC data size and the
  799.                 maximum allowed LLC data size inclusive and that
  800.                 does not match the number of LLC data octets
  801.                 received.
  802.  
  803.                 The count represented by an instance of this
  804.                 object also includes frames for which the length
  805.                 field value is less than the minimum unpadded LLC
  806.                 data size."
  807.         ::= { dot3StatsEntry 14 }
  808.  
  809.     dot3StatsOutOfRangeLengthFields OBJECT-TYPE
  810.         SYNTAX  Counter
  811.         ACCESS  read-only
  812.         STATUS  mandatory
  813.         DESCRIPTION
  814.                 "A count of frames received on a particular
  815.                 interface for which the length field value exceeds
  816.                 the maximum allowed LLC data size.
  817.  
  818.                 The count represented by an instance of this
  819.                 object is not incremented in implementations that
  820.                 observe Ethernet encapsulation conventions (by
  821.                 which the IEEE 802.3 length field is interpreted
  822.                 as the Ethernet Type field)."
  823.         ::= { dot3StatsEntry 15 }
  824.  
  825.     dot3StatsInternalMacReceiveErrors OBJECT-TYPE
  826.         SYNTAX  Counter
  827.         ACCESS  read-only
  828.         STATUS  mandatory
  829.         DESCRIPTION
  830.                 "A count of frames for which reception on a
  831.                 particular interface fails due to an internal MAC
  832.                 sublayer receive error. A frame is only counted by
  833.                 an instance of this object if it is not counted by
  834.                 the corresponding instance of either the
  835.                 dot3StatsFrameTooLongs object, the
  836.                 dot3StatsAlignmentErrors object, the
  837.                 dot3StatsFCSErrors object, the
  838.                 dot3StatsInRangeLengthErrors object, or the
  839.  
  840.  
  841.  
  842. Transmission MIB Working Group                                 [Page 15]
  843.  
  844. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  845.  
  846.  
  847.                 dot3StatsOutOfRangeLengthFields object.
  848.  
  849.                 The precise meaning of the count represented by an
  850.                 instance of this object is implementation-
  851.                 specific.  In particular, an instance of this
  852.                 object may represent a count of receive errors on
  853.                 a particular interface that are not otherwise
  854.                 counted."
  855.         ::= { dot3StatsEntry 16 }
  856.  
  857.  
  858.     -- the Ethernet-like Collision Statistics group
  859.  
  860.     -- Implementation of this group is optional; it is appropriate
  861.     -- for all systems which have the necessary metering
  862.  
  863.     dot3CollTable OBJECT-TYPE
  864.         SYNTAX  SEQUENCE OF Dot3CollEntry
  865.         ACCESS  not-accessible
  866.         STATUS  mandatory
  867.         DESCRIPTION
  868.                 "A collection of collision histograms for a
  869.                 particular set of interfaces."
  870.         ::= { dot3 5 }
  871.  
  872.     dot3CollEntry OBJECT-TYPE
  873.         SYNTAX  Dot3CollEntry
  874.         ACCESS  not-accessible
  875.         STATUS  mandatory
  876.         DESCRIPTION
  877.                 "A cell in the histogram of per-frame collisions
  878.                 for a particular interface.  An instance of this
  879.                 object represents the frequency of individual MAC
  880.                 frames for which the transmission (successful or
  881.                 otherwise) on a particular interface is
  882.                 accompanied by a particular number of media
  883.                 collisions."
  884.         INDEX   { dot3CollIndex, dot3CollCount }
  885.         ::= { dot3CollTable 1 }
  886.  
  887.     Dot3CollEntry ::=
  888.         SEQUENCE {
  889.             dot3CollIndex
  890.                 INTEGER,
  891.             dot3CollCount
  892.                 INTEGER,
  893.             dot3CollFrequencies
  894.                 Counter
  895.  
  896.  
  897.  
  898. Transmission MIB Working Group                                 [Page 16]
  899.  
  900. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  901.  
  902.  
  903.         }
  904.  
  905.     dot3CollIndex OBJECT-TYPE
  906.         SYNTAX  INTEGER
  907.         ACCESS  read-only
  908.         STATUS  mandatory
  909.         DESCRIPTION
  910.                 "The index value that uniquely identifies the
  911.                 interface to which a particular collision
  912.                 histogram cell pertains.  The interface identified
  913.                 by a particular value of this index is the same
  914.                 interface as identified by the same value of
  915.                 ifIndex."
  916.         ::= { dot3CollEntry 1 }
  917.  
  918.     dot3CollCount OBJECT-TYPE
  919.         SYNTAX  INTEGER (1..16)
  920.         ACCESS  read-only
  921.         STATUS  mandatory
  922.         DESCRIPTION
  923.                 "The number of per-frame media collisions for
  924.                 which a particular collision histogram cell
  925.                 represents the frequency on a particular
  926.                 interface."
  927.         ::= { dot3CollEntry 2 }
  928.  
  929.     dot3CollFrequencies OBJECT-TYPE
  930.         SYNTAX  Counter
  931.         ACCESS  read-only
  932.         STATUS  mandatory
  933.         DESCRIPTION
  934.                 "A count of individual MAC frames for which the
  935.                 transmission (successful or otherwise) on a
  936.                 particular interface is accompanied by a
  937.                 particular number of media collisions."
  938.         ::= { dot3CollEntry 3 }
  939.  
  940.  
  941.     --  802.3 Tests
  942.  
  943.     -- The ifExtnsTestTable defined in [11] provides a common means
  944.     -- for a manager to test any interface corresponding to a value
  945.     -- of ifIndex.
  946.  
  947.     -- At this time, one well known test (testFullDuplexLoopBack) is
  948.     -- defined in [11].  For ethernet-like interfaces, this test
  949.     -- configures the MAC chip and executes an internal loopback
  950.     -- test of memory and the MAC chip logic.  This loopback test can
  951.  
  952.  
  953.  
  954. Transmission MIB Working Group                                 [Page 17]
  955.  
  956. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  957.  
  958.  
  959.     -- only be executed if the interface is offline.  Once the test
  960.     -- has completed, the MAC chip should be reinitialized for network
  961.     -- operation, but it should remain offline.
  962.  
  963.     -- If an error occurs during a test, the object ifExtnsTestResult
  964.     -- (defined in [11]) will be set to failed(7).  The following two
  965.     -- OBJECT IDENTIFIERs may be used to provided more information as
  966.     -- values for the object ifExtnsTestCode in [11]:
  967.  
  968.     dot3Errors             OBJECT IDENTIFIER ::= { dot3 7 }
  969.  
  970.                               -- couldn't initialize MAC chip for test
  971.     dot3ErrorInitError     OBJECT IDENTIFIER ::= { dot3Errors 1 }
  972.  
  973.                               -- expected data not received (or not
  974.                               -- received correctly) in loopback test
  975.     dot3ErrorLoopbackError OBJECT IDENTIFIER ::= { dot3Errors 2 }
  976.  
  977.  
  978.     --  TDR Test
  979.  
  980.     -- Another test, specific to ethernet-like interfaces,
  981.     -- is Time-domain Reflectometry (TDR) which is defined
  982.     -- as follows:
  983.  
  984.     dot3Tests   OBJECT IDENTIFIER ::= { dot3 6 }
  985.     dot3TestTdr OBJECT IDENTIFIER ::= { dot3Tests 1 }
  986.  
  987.     -- A TDR test returns as its result the time interval between the
  988.     -- most recent TDR test transmission and the subsequent detection
  989.     -- of a collision.  This interval is based on a 10 MHz clock and
  990.     -- should be normalized if the time base is other than 10 MHz.
  991.     -- On successful completion of a TDR test, the result is stored
  992.     -- as the value of the appropriate instance of the MIB object
  993.     -- dot3TestTdrValue, and the OBJECT IDENTIFIER of that instance
  994.     -- is stored in the corresponding instance of ifExtnsTestResult
  995.     -- (thereby indicating where the result has been stored).
  996.  
  997.  
  998.    --  802.3 Hardware Chipsets
  999.  
  1000.    -- The object ifExtnsChipSet is provided in [11] to identify the
  1001.    -- MAC hardware used to communcate on an interface.  The following
  1002.    -- hardware chipsets are provided for 802.3:
  1003.  
  1004.    dot3ChipSets          OBJECT IDENTIFIER ::= { dot3 8 }
  1005.    dot3ChipSetAMD        OBJECT IDENTIFIER ::= { dot3ChipSets 1 }
  1006.    dot3ChipSetAMD7990    OBJECT IDENTIFIER ::= { dot3ChipSetAMD 1 }
  1007.  
  1008.  
  1009.  
  1010. Transmission MIB Working Group                                 [Page 18]
  1011.  
  1012. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  1013.  
  1014.  
  1015.    dot3ChipSetAMD79900   OBJECT IDENTIFIER ::= { dot3ChipSetAMD 2 }
  1016.  
  1017.    dot3ChipSetIntel      OBJECT IDENTIFIER ::= { dot3ChipSets 2 }
  1018.    dot3ChipSetIntel82586 OBJECT IDENTIFIER ::= { dot3ChipSetIntel 1 }
  1019.    dot3ChipSetIntel82596 OBJECT IDENTIFIER ::= { dot3ChipSetIntel 2 }
  1020.  
  1021.    dot3ChipSetSeeq       OBJECT IDENTIFIER ::= { dot3ChipSets 3 }
  1022.    dot3ChipSetSeeq8003   OBJECT IDENTIFIER ::= { dot3ChipSetSeeq 1 }
  1023.  
  1024.    dot3ChipSetNational      OBJECT IDENTIFIER ::= { dot3ChipSets 4 }
  1025.    dot3ChipSetNational8390  OBJECT IDENTIFIER ::=
  1026.                                              { dot3ChipSetNational 1 }
  1027.    dot3ChipSetNationalSonic OBJECT IDENTIFIER ::=
  1028.                                              { dot3ChipSetNational 2 }
  1029.  
  1030.    dot3ChipSetFujitsu       OBJECT IDENTIFIER ::= { dot3ChipSets 5 }
  1031.    dot3ChipSetFujitsu86950  OBJECT IDENTIFIER ::=
  1032.                                             { dot3ChipSetFujitsu 1 }
  1033.  
  1034.    -- For those chipsets not represented above, OBJECT IDENTIFIER
  1035.    -- assignment is required in other documentation, e.g., assignment
  1036.    -- within that part of the registration tree delegated to
  1037.    -- individual enterprises (see [3]).
  1038.  
  1039.    END
  1040.  
  1041. 6.  Acknowledgements
  1042.  
  1043.    This document was produced by the Transmission MIB Working Group.
  1044.  
  1045.    This document is based on a document written by Frank Kastenholz of
  1046.    Interlan entitled IEEE 802.3 Layer Management Draft M compatible MIB
  1047.    for TCP/IP Networks [10].  This document has been modestly reworked,
  1048.    initially by the SNMP Working Group, and then by the Transmission
  1049.    Working Group, to reflect the current conventions for defining
  1050.    objects for MIB interfaces.  James Davin, of the MIT Laboratory for
  1051.    Computer Science, and Keith McCloghrie of Hughes LAN Systems,
  1052.    contributed to later drafts of this memo. Marshall Rose of
  1053.    Performance Systems International, Inc. converted the document into
  1054.    its current concise format.  Thanks to Frank Kastenholz of Interlan
  1055.    and Louis Steinberg of IBM for their experimentation.
  1056.  
  1057. 7.  References
  1058.  
  1059.    [1] Cerf, V., "IAB Recommendations for the Development of Internet
  1060.        Network Management Standards", RFC 1052, NRI, April 1988.
  1061.  
  1062.    [2] Cerf, V., "Report of the Second Ad Hoc Network Management Review
  1063.  
  1064.  
  1065.  
  1066. Transmission MIB Working Group                                 [Page 19]
  1067.  
  1068. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  1069.  
  1070.  
  1071.        Group", RFC 1109, NRI, August 1989.
  1072.  
  1073.    [3] Rose M., and K. McCloghrie, "Structure and Identification of
  1074.        Management Information for TCP/IP-based internets", RFC 1155,
  1075.        Performance Systems International, Hughes LAN Systems, May 1990.
  1076.  
  1077.    [4] McCloghrie K., and M. Rose, "Management Information Base for
  1078.        Network Management of TCP/IP-based internets", RFC 1156, Hughes
  1079.        LAN Systems, Performance Systems International, May 1990.
  1080.  
  1081.    [5] Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple
  1082.        Network Management Protocol", RFC 1157, SNMP Research,
  1083.        Performance Systems International, Performance Systems
  1084.        International, MIT Laboratory for Computer Science, May 1990.
  1085.  
  1086.    [6] McCloghrie K., and M. Rose, Editors, "Management Information Base
  1087.        for Network Management of TCP/IP-based internets", RFC 1213,
  1088.        Performance Systems International, March 1991.
  1089.  
  1090.    [7] Information processing systems - Open Systems Interconnection -
  1091.        Specification of Abstract Syntax Notation One (ASN.1),
  1092.        International Organization for Standardization, International
  1093.        Standard 8824, December 1987.
  1094.  
  1095.    [8] Information processing systems - Open Systems Interconnection -
  1096.        Specification of Basic Encoding Rules for Abstract Notation One
  1097.        (ASN.1), International Organization for Standardization,
  1098.        International Standard 8825, December 1987.
  1099.  
  1100.    [9] IEEE, "IEEE 802.3 Layer Management", November 1988.
  1101.  
  1102.   [10] Kastenholz, F., IEEE 802.3 Layer Management Draft compatible MIB
  1103.        for TCP/IP Networks, electronic mail message to mib-
  1104.        wg@nnsc.nsf.net,  9 June 1989.
  1105.  
  1106.   [11] McCloghrie, K., Editor, "Extensions to the Generic-Interface
  1107.        MIB", RFC 1229, Hughes LAN Systems, Inc., May 1991.
  1108.  
  1109.   [12] IEEE, "Carrier Sense Multiple Access with Collision Detection
  1110.        (CSMA/CD) Access Method and Physical Layer Specifications",
  1111.        ANSI/IEEE Std 802.3-1985.
  1112.  
  1113.   [13] Rose, M., and K. McCloghrie, Editors, "Concise MIB Definitions",
  1114.        RFC 1212, Performance Systems International, Hughes LAN Systems,
  1115.        March 1991.
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122. Transmission MIB Working Group                                 [Page 20]
  1123.  
  1124. RFC 1284                 ETHERNET-LIKE OBJECTS             December 1991
  1125.  
  1126.  
  1127. Security Considerations
  1128.  
  1129.    Security issues are not discussed in this memo.
  1130.  
  1131. Author's Address
  1132.  
  1133.    John Cook
  1134.    Chipcom Corporation
  1135.    118 Turnpike Road
  1136.    Southborough, MA  01772
  1137.  
  1138.    For more information, contact the chair of the Ethernet MIB working
  1139.    group:
  1140.  
  1141.    Frank Kastenholz
  1142.    Clearpoint Research Inc
  1143.    35 Parkwood Drive
  1144.    Hopkinton Mass 01748
  1145.  
  1146.    Phone: 508-435-2000
  1147.    EMail: kasten@europa.clearpoint.com
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178. Transmission MIB Working Group                                 [Page 21]
  1179.